home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / filutil / mdf130.zip / MDF_ITA.DOC < prev    next >
Text File  |  1995-01-12  |  14KB  |  407 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                                   MDIFF  -  MPATCH
  12.                                     Release  1.3
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.           Un software semplice ma completo per produrre e applicare patch a
  24.                               programmi e file di dati.
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                              Manuale in lingua italiana.
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.                (C) 1994/95 Maurizio Giunti - Tutti i diritti riservati
  47.  
  48.  
  49.  
  50.  
  51.  
  52.      0.SOMMARIO
  53.  
  54.  
  55.      0.SOMMARIO                                                               2
  56.  
  57.  
  58.      1.PERCHE'                                                                3
  59.  
  60.  
  61.      2.A COSA SERVE                                                           3
  62.  
  63.  
  64.      3.DOS E OS/2                                                             3
  65.  
  66.  
  67.      4.LIMITI                                                                 3
  68.  
  69.  
  70.      5.MDIFF - MDIFF2                                                         3
  71.  
  72.  
  73.      6.MPATCH - MPATCH2                                                       4
  74.  
  75.  
  76.      7.ALCUNI CONSIGLI                                                        4
  77.  
  78.  
  79.      8.DIRITTI                                                                5
  80.  
  81.  
  82.      9.GARANZIE                                                               5
  83.  
  84.  
  85.      10.LIBRERIE PER APPLICARE PATCH                                          5
  86.  
  87.  
  88.      11.COME REGISTRARSI                                                      6
  89.  
  90.  
  91.      12.RINGRAZIAMENTI                                                        6
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.                                                                               2
  107.  
  108.  
  109.  
  110.  
  111.  
  112.      1.PERCHE'
  113.      Qualche tempo  fa dovevo  rilasciare una  versione aggiornata  di un  mio
  114.      programma: il pacchetto compresso "pesava"  piu' di 200 Kbyte,  e sarebbe
  115.      stato sicuramente  piu'  conveniente  per  tutti  aggiornare  il  vecchio
  116.      eseguibile tramite una patch.   Mi misi in caccia  di un software che  mi
  117.      permettesse di creare e distribuire patch  dei miei programmi  per Dos  e
  118.      OS/2: per Dos ne ho trovati alcuni (ma non mi hanno soddisfatto  per vari
  119.      motivi),  per  OS/2  neanche  uno!  Ho  quindi  deciso  di   farmene  uno
  120.      e....eccolo qui ! 8-)
  121.  
  122.  
  123.  
  124.      2.A COSA SERVE
  125.      MDIFF crea un file binario  di differenza tra due  file. Con MPATCH e  il
  126.      vecchio file  si  puo' ricreare  il  nuovo file    partendo dal  file  di
  127.      differenza. Cosa c'e' di buono in tutto cio'? Semplice: supponendo che il
  128.      file di differenza sia   piu' breve del  nuovo file, e' piu'  conveniente
  129.      distribuire solo  quello  invece di  tutto  il file,  soprattutto  se  la
  130.      distribuzione avviene via modem.
  131.  
  132.  
  133.  
  134.      3.DOS E OS/2
  135.      Nel pacchetto di  distribuzione troverete quattro  files eseguibili,  due
  136.      per Dos e due per OS/2 32bit. Non c'e' alcuna  differenza  nella funzione
  137.      e nell'uso  dei  programmi  sui  due sistemi  operativi.  I  files  *.MDF
  138.      prodotti con MDIFF per  Dos possono essere utilizzati con MPATCH per OS/2
  139.      e viceversa.
  140.  
  141.  
  142.  
  143.      4.LIMITI
  144.      MDIFF non puo' trattare files piu' ampi di 16 Megabyte. Questo e' l'unico
  145.      limite fisico di MDIFF.
  146.  
  147.  
  148.  
  149.      5.MDIFF - MDIFF2
  150.      Il programma MDIFF si occupa di comparare due files e di immagazzinare le
  151.      differenze tra di essi in un terzo file  che, generalmente, e' molto piu'
  152.      compatto. Vediamo come si usa:
  153.  
  154.        MDIFF [-C<c>] [-R<r>] [-F<f>] [-S] [-Z] <OldFile> <NewFile> [<MDFfile>]
  155.  
  156.      <OldFile> ovviamente e'  il nome  della versione precedente  del file  da
  157.      comparare, mentre  <NewFile>  e' il  nome  della   versione  attuale.  Se
  158.      necessario si puo' specificare il nome  del file di differenza da  creare
  159.      <MDFfile>, altrimenti   MDIFF  crea un  file  che ha  lo stesso  nome  di
  160.      <NewFile> ma estensione ".MDF".  Per cercare le  parti simili nei  files,
  161.      MDIFF si serve di una stringa base di lunghezza predefinita  detta chunk.
  162.      La lunghezza del chunk e' per default di  16 byte ma puo' essere cambiata
  163.      (in un range  4-256) con  lo switch  -C seguito  dalla lunghezza  voluta.
  164.      Quando  MDIFF perde il sincronismo tra i due files che  sta confrontando,
  165.      cerca di ritrovarlo scandendo il vecchio file alla  ricerca del chunk che
  166.                                                                               3
  167.  
  168.  
  169.  
  170.  
  171.      sta elaborando. Tale ricerca viene effettuata, in un  intorno dell'ultimo
  172.      chunk trovato, nel range definito dallo switch -R. Per default tale range
  173.      e' di 8 blocchi di 512 byte, ma puo' variare tra 1 e 16. Se tale  ricerca
  174.      fallisce MDIFF cerca di forzare il sincronismo cercando in un raggio piu'
  175.      ampio di quello definito solitamente ampio 1/16 della lunghezza del file.
  176.      Questa seconda  ricerca puo'  essere disabilitata  o  il suo  range  puo'
  177.      essere cambiato tramite lo  switch -F. Specificando lo  switch  -S,  alla
  178.      fine dell'operazione, MDIFF  fornira' alcuni dati sulla  composizione del
  179.      file di differenza.
  180.      E' inoltre  possibile,  tramite  lo  switch  -Z,  inserire  nel  file  di
  181.      differenza un breve commento (al massimo 2 Kbyte), che sara' visualizzato
  182.      durante l'applicazione della patch da parte di MPATCH. Il  commento viene
  183.      prelevato direttamente  dallo  standard  input e  quindi  puo'  essere  o
  184.      digitato o prelevato da un file tramite l'apposito comando di redirezione
  185.      "<".
  186.  
  187.  
  188.  
  189.      6.MPATCH - MPATCH2
  190.      MDIFF sarebbe  un  programma inutile  se  non esistesse  MPATCH.  Infatti
  191.      MPATCH si occupa,  dati <OldFile>  e  <MDFfile>,  di ricreare  <NewFile>.
  192.      Vediamo come si usa:
  193.  
  194.                       MPATCH <MDFfile> [<OldFile>] [<NewFile>]
  195.  
  196.      L'unico parametro necessario e' il nome del file di  differenza <MDFfile>
  197.      perche' esso  contiene i  nomi degli  altri due   file,  ma e'  possibile
  198.      modificare tale impostazione   semplicemente specificando  i nomi  voluti
  199.      nell'esatto  ordine.     MPATCH  non  ha   nessuno  switch  o   parametro
  200.      particolare.
  201.      In  caso  di  errore  MPATCH  ritorna  un  errorlevel  che   deve  essere
  202.      interpretato secondo la seguente tabella:
  203.         Codice   Descrizione
  204.           0      "OK!"
  205.                  "Out of memory !"          1
  206.                  "Can't open MDF file !"          2
  207.                  "Invalid MDF file !"          3
  208.           4      "MDF file version mismatch !"
  209.                  "UNREGISTERED !"          5
  210.                  "Bad or incorrect OLD file !"          6
  211.           7      "Can't open OLD file !"
  212.           8      "Can't create NEW file !"
  213.           9      "General failure: NEW file corrupted !"
  214.           10     "OLD and NEW can't be the same file !"
  215.  
  216.  
  217.  
  218.      7.ALCUNI CONSIGLI
  219.      Il metodo ottimale per costruire un file di differenza sarebbe  quello di
  220.      ricercare per tutto  il vecchio file  i chunks   che compongono il  nuovo
  221.      file;  ovviamente  tale  metodo  sarebbe  di  una  lentezza  esasperante.
  222.      L'algoritmo su  cui  e'   basato  MDIFF rappresenta  un  compromesso  tra
  223.      risultato e velocita'  di esecuzione,  per questo  e' talvolta  opportuno
  224.      regolare i  parametri  di funzionamento  di  MDIFF tramite  gli  appositi
  225.      switch. Vediamo come comportarsi in  alcune situazioni tipiche:
  226.                                                                               4
  227.  
  228.  
  229.  
  230.  
  231.      1.        File con pochissime modifiche: e'  opportuno utilizzare un chunk  molto
  232.        ampio (32,  64  o piu')  in  modo da    ridurre il  piu'  possibile  le
  233.        dimensioni del file di differenza, soprattutto se si sta' lavorando con
  234.        files di testo o con archivi.
  235.      2.        File di testo: di solito un chunk di dimensione 32 e' il piu' indicato,
  236.        e' opportuno provare  a diminuire  o togliere il   sincronismo  forzato
  237.        tramite lo switch -F.
  238.        File eseguibili molto  ampi: spesso   si  ottengono risultati  migliori     3. 
  239.        allargando il range di ricerca del  sincronismo  tramite lo switch -R.
  240.      Un ultimo consiglio:  non attendetevi miracoli  da MDIFF. Se  i due  file
  241.      confrontati sono molto dissimili il file di patch risultera' molto ampio.
  242.      In questi casi c'e' ben poco  da fare, bisogna rassegnarsi a  distribuire
  243.      il nuovo file  interamente. MDIFF e'  realmente utile solo  se il  numero
  244.      delle modifiche apportate ai file non e' troppo grande.
  245.  
  246.  
  247.      8.DIRITTI
  248.      Questo  software   appartiene alla categoria   dei  programmi  Shareware:
  249.      chiunque lo puo'  liberamente copiare ed   utilizzare per  un periodo  di
  250.      prova di    15 giorni.    Dopo   tale   periodo,  l'utente  che  desideri
  251.      continuare ad    utilizzarlo e'  tenuto  a registrare  la  propria  copia
  252.      inviando la quota di registrazione all'autore, Maurizio  Giunti.
  253.      Gli utenti che pagano la quota  di registrazione riceveranno una  "chiave
  254.      di registrazione" personale e non cedibile, che rendera'  "registrata" la
  255.      propria copia del programma.
  256.      Chiunque puo' ridistribuire questo software a condizione che non richieda
  257.      alcuna somma di denaro in cambio, fatta  eccezione per le spese  di copia
  258.      e/o di spedizione che, pero', devono essere adeguatamente documentate.
  259.      Altra condizione per la libera distribuzione e' che venga  sempre fornito
  260.      per intero il contenuto del pacchetto di  distribuzione  originale, senza
  261.      alcuna modifica ai programmi e/o alla documentazione.
  262.      Un'unica  eccezione:  il   programma  MPATCH   puo'  essere   liberamente
  263.      ridistribuito insieme ad uno o piu'  files *.MDF  prodotti con una  copia
  264.      REGISTRATA di MDIFF.
  265.  
  266.  
  267.  
  268.      9.GARANZIE
  269.      L'unica garanzia  fornita con  questo software  e' che  occupa spazio  su
  270.      disco. Non posso  assolutamente garantire che   funzioni perfettamente  o
  271.      rappresenti la soluzione di ogni vostro problema. Sono inoltre sicuro che
  272.      non e' un virus e   non contiene (a meno che non  sia stato infettato   o
  273.      modificato  dopo  la  compilazione)  Trojan-Horses,  Back-Doors  o  altre
  274.      diavolerie simili.  In ogni  caso l'autore  declina ogni  responsabilita'
  275.      diretta o indiretta, per  eventuali danni   morali o materiali  derivanti
  276.      dal suo uso.
  277.  
  278.  
  279.  
  280.      10.LIBRERIE PER APPLICARE PATCH
  281.      Nel pacchetto di  distribuzione sono  allegate alcune  librerie per  Dos,
  282.      Windows e OS/2, utili  per realizzare propri  programmi per applicare  le
  283.      patch prodotte con MDIFF.
  284.      Tali librerie  funzionano soltanto  con files  *.MDF  prodotti con  COPIE
  285.      REGISTRATE di MDIFF.
  286.                                                                               5
  287.  
  288.  
  289.  
  290.  
  291.      Il pacchetto contenente le  librerie e' corredato  di alcuni sorgenti  di
  292.      esempio in C, C++ e VisualBasic e di tutta la  documentazione necessaria.
  293.  
  294.  
  295.  
  296.      11.COME REGISTRARSI
  297.      Il costo della  chiave di  registrazione individuale, valida  sia per  la
  298.      versione Dos che per  quella OS/2, e' di  25.000 lire italiane (circa  16
  299.      U.S.$) spese  di  spedizione  della chiave  comprese.  Site-license  sono
  300.      disponibili  a  richiesta.  Il  codice  di  registrazione  sara'  spedito
  301.      tramite normale lettera, oppure, a richiesta, via e-mail.
  302.      La  registrazione  puo'  essere  effettuata  in  qualsiasi  modo,  ma  e'
  303.      consigliabile  l'utilizzo di vaglia   postale in Italia o   International
  304.      Postal Check in Lire Italiane dall'estero, pagabile all'ufficio   postale
  305.      di "FIRENZE" ed intestato al  seguente nominativo:
  306.  
  307.                                    Maurizio Giunti
  308.                                 Via G.B. Foggini, 24
  309.                                  50142 Firenze (FI)
  310.                                         ITALY
  311.  
  312.      E' importante  indicare  bene,  nel  vaglia, il  nome  del  programma  da
  313.      registrare, il proprio  nome, cognome, indirizzo  e indirizzo e-mail  (se
  314.      necessario).  Chi  voglia  fare   delle  comunicazioni  puo'   utilizzare
  315.      l'apposito spazio sullo stesso  vaglia, oppure puo'  spedire un e-mail  a
  316.      "Maurizio Giunti" ai seguenti indirizzi:
  317.  
  318.                                 Fidonet: 2:332/102.3
  319.  
  320.                           Internet: giunti@stat.ds.unifi.it
  321.  
  322.  
  323.  
  324.      12.RINGRAZIAMENTI
  325.      Vorrei brevemente  ringraziare  gli  amici che  mi  hanno  aiutato  nello
  326.      sviluppo di questo software  e della  documentazione  allegata, o che  si
  327.      sono coraggiosamente offerti come beta-testers. In ordine alfabetico:
  328.  
  329.  
  330.                                    Andrea Baitelli
  331.  
  332.                                     Silvia Borri
  333.  
  334.                                     Filippo Dini
  335.  
  336.                                  Fabrizio Fioravanti
  337.  
  338.                                  Cristiano Guidoccio
  339.  
  340.                                 Giovanni Lopes Pegna
  341.  
  342.                                   Marco Maccaferri
  343.  
  344.                                   Marco Menichelli
  345.  
  346.                                                                               6
  347.  
  348.  
  349.  
  350.  
  351.                                    Giuseppe Scarpi
  352.  
  353.                                    Toni Tatafiore
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.                                                                               7
  407.